home *** CD-ROM | disk | FTP | other *** search
/ Java Programmer's Toolkit / Java Programmer's Toolkit.iso / gs3.53 / psfiles.doc < prev    next >
Text File  |  1996-01-10  |  7KB  |  202 lines
  1.    Copyright (C) 1990, 1995 Aladdin Enterprises.  All rights reserved.
  2.   
  3.   This file is part of Aladdin Ghostscript.
  4.   
  5.   Aladdin Ghostscript is distributed with NO WARRANTY OF ANY KIND.  No author
  6.   or distributor accepts any responsibility for the consequences of using it,
  7.   or for whether it serves any particular purpose or works at all, unless he
  8.   or she says so in writing.  Refer to the Aladdin Ghostscript Free Public
  9.   License (the "License") for full details.
  10.   
  11.   Every copy of Aladdin Ghostscript must include a copy of the License,
  12.   normally in a plain ASCII text file named PUBLIC.  The License grants you
  13.   the right to copy, modify and redistribute Aladdin Ghostscript, but only
  14.   under certain conditions described in the License.  Among other things, the
  15.   License requires that the copyright notice and this notice be preserved on
  16.   all copies.
  17.  
  18. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  19.  
  20. This file, psfiles.doc, describes the .ps files distributed with
  21. Ghostscript, other than fonts.
  22.  
  23. For an overview of Ghostscript and a list of the documentation files, see
  24. README.
  25.  
  26. System files
  27. ------------
  28.  
  29. gs_init.ps - Ghostscript reads this automatically when it starts up.  It
  30. contains definitions of many standard procedures and initialization for a
  31. wide variety of things.
  32.  
  33. gs_btokn.ps - gs_init.ps reads this in if the btoken feature is included in
  34. the configuration.  It provides support for binary tokens.
  35.  
  36. gs_ccfnt.ps - gs_init.ps reads this in if the ccfonts feature is included
  37. in the configuration.  It provides support for compiled fonts.
  38.  
  39. gs_cmdl.ps - This file is not used yet.  Eventually it will replace C code
  40. that parses the Ghostscript command line.
  41.  
  42. gs_fonts.ps - gs_init.ps reads this in.  It initializes Ghostscript's font
  43. machinery and provides some utility procedures that work with fonts.
  44.  
  45. gs_kanji.ps - This file provides support for the Wadalab free Kanji font.
  46.  
  47. gs_pfile.ps - This file provides runtime support for packed fonts.
  48.  
  49. gs_statd.ps - gs_init.ps reads this in.  It creates a dummy statusdict and
  50. some other environmental odds and ends for the benefit of PostScript files
  51. that really want to be printed on a LaserWriter.
  52.  
  53. gs_dps1.ps - gs_init.ps reads this in if the dps feature is included in
  54. the configuration.  It provides support for various Display PostScript and
  55. Level 2 features.
  56.  
  57. gs_lev2.ps - gs_init.ps reads this in if the Ghostscript interpreter
  58. includes Level 2 PostScript functions.  It contains definitions of
  59. procedures and miscellaneous initialization for the Level 2 functions.
  60.  
  61. gs_res.ps - gs_init.ps reads this in if the Level 2 resource machinery is
  62. included.  Currently, this is the case for all Level 2 configurations.
  63.  
  64. gs_type0.ps - gs_init.ps reads this in if the Ghostscript interpreter
  65. includes composite (Type 0) font capability.
  66.  
  67. gs_type1.ps - gs_init.ps reads this in if the Ghostscript interpreter
  68. includes Type 1 font capability (which it normally does).
  69.  
  70. gs_*_e.ps - These files define the Encodings known to Ghostscript.  All of
  71. them except gs_std_e.ps and gs_iso_e.ps are loaded only if referenced.
  72.  
  73. More system files (PDF-related)
  74. -------------------------------
  75.  
  76. gs_pdf.ps - The ProcSet that provides runtime support for PDF files.
  77.  
  78. pdf_2ps.ps - The additions to the PDF interpreter that allow it to convert
  79. PDF to PostScript.
  80.  
  81. pdf_base.ps - Utilities for interpreting PDF objects and streams.
  82.  
  83. pdf_draw.ps - The interpreter for drawing-related PDF operations.
  84.  
  85. pdf_font.ps - Code for handling fonts in PDF files.
  86.  
  87. pdf_main.ps - Document- and page-level control for interpreting PDF files.
  88.  
  89. Art
  90. ---
  91.  
  92. chess.ps - A black-and-white chessboard.
  93.  
  94. golfer.ps - A gray-scale picture of a stylishly dressed woman swinging a
  95. golf club.
  96.  
  97. escher.ps - A colored version of a hexagonally symmetric Escher drawing of
  98. interlocking butterflies.  Can be printed on monochrome devices, with
  99. somewhat less dramatic results.
  100.  
  101. cheq.ps - A chessboard "font" used by chess.ps (obtained from the Adobe
  102. file server).
  103.  
  104. snowflak.ps - A rectangular grid of intricate colored snowflakes.
  105. (Renders very slowly.)
  106.  
  107. colorcir.ps - A set of nested ellipses made up of colored bars.
  108.  
  109. tiger.ps - A dramatic colored picture of a tiger's head.
  110.  
  111. Utilities
  112. ---------
  113.  
  114. For more information on these utility programs, see the comments at the
  115. beginning of the files.  The ones marked with * have batch files or shell
  116. scripts of the same name (e.g., bdftops, bdftops.bat) to invoke them
  117. conveniently.
  118.  
  119. bench.ps - a file useful for running benchmarks.
  120.  
  121. * bdftops.ps - a utility for converting BDF fonts to outline form: see
  122. fonts.doc for more information.
  123.  
  124. caption.ps - a file for putting a caption in a box at the bottom of each
  125. page, useful for trade show demos.
  126.  
  127. docie.ps - an emulation of the CIE color mapping algorithms.
  128.  
  129. * gslp.ps - a utility for doing "line printing" of plain text files.
  130.  
  131. impath.ps - a utility for reconstructing outlines from bitmap images,
  132. used by bdftops.
  133.  
  134. landscap.ps - a file that you can put in front of your own files to get
  135. them rendered in landscape mode.
  136.  
  137. level1.ps - a file that turns off any Level 2 features.
  138.  
  139. packfile.ps - a utility for compressing fonts into a single file.
  140.  
  141. prfont.ps - a utility to print a font catalog.
  142.  
  143. * ps2ascii.ps - a utility for extracting the ASCII text from PostScript
  144. source files.  It redefines many operators.  For more information, see the
  145. comments in the file.
  146.  
  147. ps2ai.ps - a utility for converting an arbitrary PostScript file into a
  148. form compatible with Adobe Illustrator.
  149.  
  150. * ps2epsi.ps - a utility for converting an arbitrary PostScript file into
  151. EPSI form.
  152.  
  153. * pstoppm.ps - a utility for rendering PostScript files onto PPM (bitmap)
  154. files.
  155.  
  156. quit.ps - a file containing just the word "quit".  (The -c switch now makes
  157. this unnecessary; this file exists for backward compatibility.)
  158.  
  159. showpage.ps - a file containing just the word "showpage".  (The -c switch
  160. now makes this unnecessary; this file exists for backward compatibility.)
  161.  
  162. viewgif.ps - a utility for displaying GIF files.
  163.  
  164. waterfal.ps - a utility to print a "waterfall" of fonts at different
  165. sizes.
  166.  
  167. Development tools
  168. -----------------
  169.  
  170. decrypt.ps - a utility for decrypting the eexec section of a font.
  171.  
  172. markpath.ps - a utility for showing the points on a path.
  173.  
  174. pcharstr.ps - a utility for printing out the CharStrings and Subrs in a
  175. Type 1 font.
  176.  
  177. ppath.ps - a couple of utilities for printing out the current path, for
  178. debugging.
  179.  
  180. traceop.ps - a utility for tracing uses of any procedure or operator
  181. for debugging.
  182.  
  183. type1enc.ps - the Type 1 font format encryption and decryption
  184. algorithms written in PostScript.
  185.  
  186. unprot.ps - a prologue to disable access checking.
  187.  
  188. winmaps.ps - a utility for creating mappings between the Adobe encodings
  189. and the Microsoft Windows character sets.
  190.  
  191. wrfont.ps - a utility for writing out an unprotected Type 1 font, such as
  192. the standard Ghostscript fonts.
  193.  
  194. Odds and ends
  195. -------------
  196.  
  197. align.ps - a simple test page for verifying margins and offsets.
  198.  
  199. lines.ps - a test program for line joins and caps.
  200.  
  201. type1ops.ps - the Type 1 font format opcodes.
  202.